package com.smart.community.property.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.smart.community.commons.entity.property.PropertyCompanyCommunity;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 物业公司社区关联Mapper接口
 * @author Wu.Liang
 * @since 2025-06-29
 * @version 1.0.0
 */
@Mapper
public interface PropertyCompanyCommunityMapper extends BaseMapper<PropertyCompanyCommunity> {
    
    /**
     * 根据物业公司ID查询关联列表
     * @param propertyCompanyId 物业公司ID
     * @return 关联列表
     */
    List<PropertyCompanyCommunity> selectByPropertyCompanyId(@Param("propertyCompanyId") Long propertyCompanyId);
    
    /**
     * 根据社区ID查询关联列表
     * @param communityId 社区ID
     * @return 关联列表
     */
    List<PropertyCompanyCommunity> selectByCommunityId(@Param("communityId") Long communityId);
    
    /**
     * 根据物业公司ID和社区ID查询关联信息
     * @param propertyCompanyId 物业公司ID
     * @param communityId 社区ID
     * @return 关联信息
     */
    PropertyCompanyCommunity selectByPropertyCompanyIdAndCommunityId(@Param("propertyCompanyId") Long propertyCompanyId, @Param("communityId") Long communityId);
    
    /**
     * 根据物业公司ID查询社区ID列表
     * @param propertyCompanyId 物业公司ID
     * @return 社区ID列表
     */
    List<Long> selectCommunityIdsByPropertyCompanyId(@Param("propertyCompanyId") Long propertyCompanyId);
    
    /**
     * 根据社区ID查询物业公司ID列表
     * @param communityId 社区ID
     * @return 物业公司ID列表
     */
    List<Long> selectPropertyCompanyIdsByCommunityId(@Param("communityId") Long communityId);
    
    /**
     * 根据状态查询关联列表
     * @param status 状态
     * @return 关联列表
     */
    List<PropertyCompanyCommunity> selectByStatus(@Param("status") Integer status);
    
    /**
     * 根据用户权限过滤查询物业公司社区关联
     * @param propertyCompanyId 物业公司ID
     * @param userCommunityIds 用户可访问的社区ID列表
     * @return 过滤后的关联列表
     */
    List<PropertyCompanyCommunity> selectByPropertyCompanyIdWithPermission(
            @Param("propertyCompanyId") Long propertyCompanyId, 
            @Param("userCommunityIds") List<Long> userCommunityIds);
    
    /**
     * 根据物业公司ID删除关联信息
     * @param propertyCompanyId 物业公司ID
     * @return 删除数量
     */
    int deleteByPropertyCompanyId(@Param("propertyCompanyId") Long propertyCompanyId);
    
    /**
     * 根据社区ID删除关联信息
     * @param communityId 社区ID
     * @return 删除数量
     */
    int deleteByCommunityId(@Param("communityId") Long communityId);
    
    /**
     * 根据物业公司ID和社区ID删除关联信息
     * @param propertyCompanyId 物业公司ID
     * @param communityId 社区ID
     * @return 删除数量
     */
    int deleteByPropertyCompanyIdAndCommunityId(@Param("propertyCompanyId") Long propertyCompanyId, @Param("communityId") Long communityId);
    
    /**
     * 检查物业公司与社区是否已关联
     * @param propertyCompanyId 物业公司ID
     * @param communityId 社区ID
     * @return 关联记录数量
     */
    int checkExists(@Param("propertyCompanyId") Long propertyCompanyId, @Param("communityId") Long communityId);
    
    /**
     * 检查物业公司与社区的关联是否存在
     * @param propertyCompanyId 物业公司ID
     * @param communityId 社区ID
     * @return 是否存在
     */
    Boolean existsByPropertyCompanyIdAndCommunityId(@Param("propertyCompanyId") Long propertyCompanyId, @Param("communityId") Long communityId);
    
    /**
     * 批量插入关联信息
     * @param propertyCompanyId 物业公司ID
     * @param communityIds 社区ID列表
     * @return 插入数量
     */
    int batchInsert(@Param("propertyCompanyId") Long propertyCompanyId, @Param("communityIds") List<Long> communityIds);
    
    /**
     * 批量删除关联信息
     * @param propertyCompanyId 物业公司ID
     * @param communityIds 社区ID列表
     * @return 删除数量
     */
    int batchDelete(@Param("propertyCompanyId") Long propertyCompanyId, @Param("communityIds") List<Long> communityIds);
} 